Aminet 6/Aminet 6 - June 1995.iso/Aminet/biz/dbase/GenTree.lzh/GenTree/Docs/Main

Text File | 1995-03-10 | 80.8 KB | 1,508 lines

1    Introduction

1.1    What is GenTree?

    The Genealogical/Family Tree Program for the Amiga Series of computers
is a multi-media program for creating, organizing, and maintaining family trees.  Using
GenTree, you can create family trees containing unlimited number of members.  It orga-
nizes your data, binding text with graphics, sounds, and annotated text.  You can create
and print pedigree charts, descendant charts, and family groups.

1.2    Copyright Notice And Disclaimer

    This manual and the software described in it are Copyright © 1994 Thomas G.
Grubb.  All rights reserved.  The software is delivered "as is", you rely on the program
and results solely at your own risk.  The software is shareware.  If you like it and use it,
please send $20 to:

Thomas G.  Grubb
15439 Empress Way
Bowie, Md. 20716 USA

    When you register the software, you will be mailed (either electronically or tradi-
tionally) the program GEDCOMConverter.  This is a utility which converts GenTree da-
tabases to the Genealogical Data Communications (GEDCOM) Standard files.

    The software must be distributed with this notice and all files intact.  You are free
to copy and distribute this archive.  No fees may be charged beyond a nominal copying
fee (less than $6).

1.3    Major Feature List

GenTree is a very powerful genealogical program.  Some features are:
·    Provides unlimited number of members (limited by ram for the central database
file) distributed over an unlimited number of storage media.
·    Provides unlimited number of pictures (displayable on the computer) that may  be
associated with members.  You can compile a family album for your family.  Pic-
tures, brushes and anim brushes are all directly supported by GenTree.  With the
correct player, you can show 24-bit IFF and full screen animations.
·    Provides unlimited number of sounds (playable on the computer) that may be
associated with members.  Listen to digitized samples of your relative's voices or
even their favorite songs.
·    Provides unlimited number of annotated notes about member records.
·    Provides unlimited number of source references about member records.
·    Provides member records that may have an unlimited number of spouses, chil-
dren, occupations, and residences.
·    Provides compatibility with other genealogical programs by converting GenTree
databases from and toGEDCOM Files (this feature is provided through the utility
you receive when you register).
·    Runs under AmigaDOS 1.3, 2.x, and 3.x.
·    Runs on the Workbench (in any resolution) to save memory.
·    Supports AppEvents under AmigaDOS 2.0+.
·    Uses Preferences to allow you to configure GenTree for your use including  Bit-
mapped and Outline fonts.  Also, you may specify your own favorite picture
viewer in order to take advantage of picture formats like JPEG or AGA.
·    Saves Preferences with each database allowing different databases to have  dif-
ferent preferences.
·    Creates Pedigree Charts as many generations deep as desired (or practical).
·    Creates Descendant Charts as many generations deep as desired (or practical).
·    Creates Family Groups.
·    Prints your entire, or a subset, GenTree database in many different ways:  indi-
vidual names, birth and death information, family information, supplemental infor-
mation, lists of pictures or sounds, notes, and sources.
·    Saves changes to the database in memory so that your modifications are not fi-
nal until you save them.

1.4    System Requirements

    GenTree requires at least 2 Meg of memory to run.  The program works well un-
der AmigaDOS 1.3, 2.x, or 3.x.  In addition, GenTree supports the 2.0 App Event.  The
program may be used from a floppy or a hard disk.

Note: It is strongly recommended that you use a hard disk and an accelerator.
While GenTree will work using floppies and the 86000 CPU, response time is
greatly increased (and user frustration decreased) with HD and a 68020+.

1.5    Installation

    GenTree is distributed as a LZH archive.  Simply extracting the archive will cre-
ate the proper directories and files needed by the program.  The directories; Pictures,
Sounds, Notes, Sources, and Persons; may be placed anywhere.  In fact, each direc-
tory could be a separate disk.

1.6    Document Organization

This document is divided into several sections and appendices:
·    Introduction - The section you are reading now.  It describes GenTree and its
features in a basic way.  Cost, system requirements, and installation are included
as well.
·    GenTree Database Organization - Contained in this chapter are structures  and
variables used by the program.  They are provided to help give a conceptual un-
derstanding of GenTree's workings.
·    Tutorial - This section guides you in making a family tree.  It provides a quick
start to using GenTree.  You learn how to start GenTree, create a family tree,
add pictures, sounds, notes and sources to your family tree, save your work, dis-
play pedigree and descendant charts, and print your family tree.
·    Reference - This section provides a reference to all the functions of the  GenTree
program.  Each screen, its menus, buttons, and purpose are detailed.
·    Appendices - The appendices discuss date formats, GenTree Genealogical Data
Communications (GEDCOM) standard support, future plans, history, and error
messages.

2    GenTree Database Organization

    GenTree divides data into 3 basic components.  First, there is the GenTree data-
base file.  This file lists all members (and their associated member records) in the cur-
rent database, the media databases to use with the member records, and other general
information.  Second, there are member records themselves which contain information
about 1 member each: name, sex, birth date, spouses, children, residences, etc.  Fi-
nally, there are Media databases which track all multimedia (pictures, sounds, text) sup-
port files used by the current GenTree database.

2.1    GenTree Database

    The GenTree database is the main "product" GenTree produces.  It tracks every
member in the database and where their member records are located.  It also points to
the media databases used by the member records.  The GenTree database is the limit
to the number of member records you may create.  The entire database file must be
able to fit into memory.

2.2    Media Databases

    There are four media DBs produced by GenTree: pictures, sounds, notes, and
sources.  Each DB tracks all the files of its type for the current database.  They contain
a logical and a physical name for each file.  The physical name points to the exact loca-
tion on disk of the media file.  The logical name is what is used to refer to the file within
your program.

    For example, you could have a picture file named TGrubb.Pic on your DH0: hard
drive.  The physical filename for the file would be "DH0:TGrubb.Pic." However, in the
program you refer to it with a logical name (255 characters Max) like "Thomas G.
Grubb, Year 1993, Age 26, at the annual family picnic."

    The Source Media database is slightly different than the others.  Like the other
media types, you have a logical name and possibly a physical file.  But, sources also
contain many other fields to completely define the source reference: classification, origi-
nator information, pubilication information, etc.

    The file formats supported by GenTree are listed in Appendix C.

2.3    Member Records

    Each member in your family tree will have a member record.  A member record
contains personal information about that member: name, sex, birth date, family, religion,
...  essentially all the information you enter in the Data Entry Windows (the Personal,
Family, and Supplemental windows defined in the reference section).  Two important
pieces of member information are a member ID and personal media databases.

Note: Member records are tracked in the GenTree Database for the family.  As
such, member records could be saved anywhere i.e.  you are not limited to 1
floppy or even 1 hard drive for all your member records.

New member records are saved in your current default persons directory.  The default
persons directory is changed in the preferences screen.  It only affects new records.

2.3.1        IDs

    Member IDs uniquely identify a member of your family tree.  Conceivably, you
could have two members with the same surname, givenname, and birth date so these
cannot be used as unique identifiers.  The member ID is used by GenTree to track that
member.

    Ordinarily, you won't have to worry about member IDs.  GenTree assigns them
automatically when you create a member.  Even when you need to specify a member
from the database, you may use requesters that list relevant members to select.

2.3.2        Personal Media Databases

    Each member has his/her own personal media databases.  The personal media
databases are used to associate media files (pictures, sounds, notes, and sources) to
the given member.  In actuality, these databases point to media files tracked in a Media
DB.  This is a powerful feature since you can refer to the same file in the same manner
from several different member records.  Not only does it help consistency between
members, it saves disk space.

    For example, you could have a picture of your family with a logical name "Family
Reunion, August 7th 1992".  Each member of the family could then point to this file in
the Picture Media DB using their personal picture DB.

3    Tutorial

3.1    Starting GenTree

    You can start GenTree from the Workbench or the CLI.

Workbench: Open the drawer in which GenTree is installed.  Double-click on the Gen-
Tree icon.  This procedure loads GenTree with a new database.  Alternatively, if you
have a database already created, double-click on your project icon and GenTree will
load with your family tree already loaded.

CLI: Change directories until you are in the GenTree directory.  Type "GenTree" to load
the program.  Type "GenTree Path&Filename" to load a previously created database.

3.2    Creating Your Family Tree

    To create a new family tree, select the New menu item (see
figure) from the main window's project menu.  If you have just
started GenTree you can skip this step.  For the tutorial, we are go-
ing to create the following family:

Godsey, Margery Ann        Born: 28-Jan-1932    Died:
Father:    Godsey, Keith Foster    Born: 6-Jul-1897     Died: 16-May-1980
Mother:    Arnold, Leah Placida    Born: 23-Apr-1892    Died: 23-Mar-1972
Spouse(s):    Grubb, Samuel Parry, Jr.
Start Date:    About 1957         End Date:    About 1970
Wedding Location: Falls Church, Virginia
Children:
Grubb, Samuel Parry, III
Grubb, Thomas Gerard

Grubb, Alexandria Kathleen        Born: 3-Jan-1988    Died:
Father:    Grubb, Samuel Parry, III
Mother:    Meeks, Julie Lynette

Grubb, Elizabeth Michelle        Born: 3-Sep-1990    Died:
Father:    Grubb, Samuel Parry, III
Mother:    Meeks, Julie Lynette

Grubb, Samuel Parry, III        Born: 3-Jul-1959    Died:
Father:    Grubb, Samuel Parry, Jr.
Mother:    Godsey, Margery Ann
Spouse(s):    Meeks, Julie Lynette
Start Date: 27-Aug-1983        End Date:
Wedding Location: Gatesville, Texas
Children:
Grubb, Alexandria Kathleen
Grubb, Elizabeth Michelle

Grubb, Samuel Parry, Jr.        Born: About 23-Oct-1931    Died:
Father:    Grubb, Samuel Parry
Mother:    Rhodes, Helen
Spouse(s):    Godsey, Margery Ann
Start Date: About 1957
End Date: About 1970
Wedding Location: Falls Church, Virginia
Children:
Grubb, Samuel Parry, III
Grubb, Thomas Gerard

Grubb, Thomas Gerard        Born: 7-Aug-1966    Died:
Father:    Grubb, Samuel Parry, Jr.
Mother:    Godsey, Margery Ann

Meeks, Julie Lynette        Born: 15-Feb-1962    Died:
Spouse(s):    Grubb, Samuel Parry, III
Start Date: 27-Aug-1983            End Date:
Wedding Location: Gatesville, Texas
Children:
Grubb, Alexandria Kathleen
Grubb, Elizabeth Michelle

    To enter members into family trees, select the Update Person menu item (see
the figure above) from the database menu (main screen).  This will bring up the per-
sonal information screen.  The personal information screen allows you to enter a
member's name, sex, birth date & place, and death date & place.  On entering the
screen, the cursor will be in the Given name field.  Type the following (<cr> is a carriage
return):
Margery Ann<cr>
Godsey<cr>
f<cr>
28 Jan 1932<cr>

    (If you typed everything correctly, your screen should look like thefigure to the
below.) OK, let's enter Margery's family information.  Click the button labeled Family Info
on the right of the screen.

    The Family Info screen allows you to connect the
members of your family tree through the various relation-
ships: spouses, children, father, and mother.  A member
may have as many spouses or children as needed.  You
can specify relationships with other members already de-
fined in the database.  Alternatively, GenTree allows you
to enter names from this screen.  The program will auto-
matically create new records for you, and each member will have the correct links en-
tered.  It saves time to let GenTree do the work, so for our tutorial enter the following
information for the spouse:

Samuel Parry, Jr.<cr>
Grubb<cr>
Falls Church, Virginia<cr>
about 1957<cr>
about 1970<cr><cr><cr>

    Your cursor should now be in the given name field for the children.  If it isn't, se-
lect that field with your mouse.  Now we want to enter the children.  Enter "Samuel
Parry, III<cr>".  After you hit the carriage return, GenTree automatically filled in the sur-
name for the child.  GenTree automatically enters the surname of the current record if
the member is male or the surname of the current spouse.
Since this is what we want, let's skip the field and press re-
turn.  Enter "M<cr>" in the gender field.  Enter the birth date
(July 3 1959).  The screen should now look like the figure at
the left.  Finish the family information by typing in Margery's
father and mother (Keith Foster, Godsey, July 8 1897, May
16 1980, Leah Placida, Arnold, April 23 1892, and March
23 1972).  At this point, GenTree has not created any new
records.  You can always tell when a record is in the data-
base because it has been assigned an ID.  To create the records, you just have to per-
form any action which requires GenTree to clear the screen.  For our purposes, we will
select Verify from Record menu.  Usually, Verify checks your cur-
rent member record for correct information.  However, since we
added a spouse, you will instead see a requester asking if you
want this spouse to be the husband of Margery's children (see fig-
ure).  Select Yes with the mouse.  Next, GenTree shows another
requester asking you if you want the parents you added to be mar-
ried.  This serves our purposes nicely so select Yes again. Finally,
after a few moments GenTree will display an information requester
stating there are no errors (If you do get errors, check the dates
and other data you entered.)

    We forgot to add one of Margery's child (Thomas Gerard).  We can add children
by selecting the button labeled Children (1 of 1) which would clear the child fields for a
new child.  This button is a radio button (as is the Spouse (1 of 1) button) which allows
us to cycle through all the current children and create new children.  However, at this
point, if we added a child this way, only the mother link would be updated.  The father
link would not be made because GenTree only makes these links when records are cre-
ated (if you added another spouse, the new child could have the new spouse as father
added automatically).  Instead, what we are going to do is duplicate the child Samuel
Parry, III's record.  Duplicating a record copies ALL information (names, dates, supple-
mental information, and family links) except for spouse information.  First, go to the child
record by select Child...  from the record menu.  Duplicate is only available as an option
from the Record menu of the Personal info screen.  Therefore, select the Personal Info
button to go to that screen.  Select Duplicate from the record menu.  The only changes
you will see is that the ID will have changed.  Also, the window title will change to reflect
the member record added to the family tree.  Change the given name to "Thomas Ger-
ard" and the birth date to "August 7 1966" (Right-Amiga-X will clear the current field).
That's it.  If you want, you can go to the family information screen to verify the links.

    Our next step will be to add the children of Samuel Parry, III: Alexandria and
Elizabeth.  First, let's enter Alexandria's information.  From the Personal Information
screen, select New under the Record menu.  You will see a blank record with a new ID
(in this case ID 7).  Enter "Alexandria Kathleen<cr>", "Grubb<cr>", "Female<cr>" (or just
"f"), and "January 3, 1988<cr>".  You'll notice that every time you enter a date,
GenTree formats the date into a standard type: DD-Mon-YYYY.  This tutorial has had
you enter the date in many different formats to show the power of GenTree's date rec-
ognition.

    Press the Family Information button to go to Alexandria's family.  So far, it's
blank.  Click on the button labelled Father.  This button will bring up a list requester (see
figure) containing all of the members in the database that could be
Alexandria's father (based on sex and age).  Double-click on Sam-
uel Parry, III to select him as the father.  GenTree will automati-
cally fill in the ID, name, and date's for the father fields.  The list
requesters that GenTree provides are very handy if you forget the
ID of a family member.  If you had remembered Samuel Parry, III's
ID number you could also have entered the ID in the father ID.
After hitting return, GenTree would have filled the father fields
from the family member with that ID.  If the ID didn't exist, no fields
would be filled.  GenTree would assume you are entering a new
member and are specifying what you would like the ID to be.  Member list requesters
are available for spouses, children, father, and mother.

    Now, let's enter the mother's information (Julie Meeks).  She doesn't exist yet so
we can't use the list requester.  Type in "Julie Lynette<cr>", "Meeks<cr>", "Feb 15,
1962<cr>".  Select the Personal Info button.  A requester will appear saying the father's
information has changed (we added a child); do we want to change his record?  Select
Yes.  Then, a requester will appear asking if you want Alexandria's parents to be mar-
ried.  Again select Yes.  When the Personal Information window appear, duplicate the
record.  Change the given name to "Elizabeth Michelle" and the birth date to
"September 3, 1990".

    The last bit of information we need to enter is the marriage information for Julie
Meeks and Samuel Parry Grubb, III.  You could use the Father or
Mother menu item from the record menu, but for the tutorial we are
going to use GenTree's search abilities.  Select the Search menu
item from the record menu or the Search button (the magnifying
glass at the bottom of the screen).  After a few moments the Search
requester will appear (see figure).  The Search requester allows
you to search for members in the database for which all data that
you enter matches.  Alternatively, you can depress New and the
requester will return you to the Person Information screen with a
new record to enter.  Let's look for Samuel Parry Grubb, III's record.
Enter "Parry" in the name field (case does not matter) and "After 1950" in the birth date
field.

    After pressing the Search button, GenTree will search your database for all
records that have Parry in their names and who were born January 1st, 1951 or later
(members with blank birth dates would also be returned).  GenTree displays the Per-
sonal Information screen.  Using the left and right arrows at the bottom of the screen (or
the Next and Previous menu items) would scroll you through all the records satisfying
the query.  In this case, only 1 record matches the query so the arrows are disabled.
Go to the Family Information screen.  As you can see, GenTree has updated the family
member's information (added Julie as a spouse and Elizabeth as a child).  Change the
marriage information: "Gatesville, Texas" for the location and "August 27, 1983" for the
wedding date.

    Select the Verify menu item.  GenTree will inform that the
marriage information has changed, and, asks if you want the
spouse's marriage information changed (see figure).  Select
Change.  If you didn't mean to change anything you could have
selected Cancel.  Selecting No will leave the spouse's information
untouched (for instance, if the spouse had a different reason for
the end of the marriage).  After a moment, verify will come back
with no errors.

    OK, we have finished entering the member information.  In the next section, you
will learn how to attach media (pictures, sounds, notes, or sources) to your family tree
members.

3.3    Adding Pictures, Sounds, Notes, And Sources

    GenTree allows you to connect pictures, sounds, notes, and sources
(references) to your family members.  The four buttons at the bottom left of the Per-
sonal, Family, or Supplemental Info screens (see figure) are
for the different media (from left to right): pictures, sounds,
notes, and sources.  Clicking any of the Media icons will
display the Personal Media window.  This window is used to
choose the pictures you want from the current family tree's media databases.

    Assuming you are still in Elizabeth's Personal Info screen,
click the Picture Icon.  The Personal Media window (see figure)
allows you to attach media (in this case pictures) to the current
member.  The list at the left of the window displays the logical
names for all pictures currently associated with the member.  The
buttons at right allow you to add to the list, remove from the list,
and search the list. If we were adding notes or sources, there
would be two other buttons: Edit loads the current selected name
into the editor (the editor is chosen through preferences), and Editor calls the chosen
editor without any files (to allow you to create new notes).  The final button, Media DB,
brings up the Media DB window.  To perform an operation, we can click on the button or
press the key underlined in the button's label.

Note: The important thing to remember is that the Personal Media Window only
allows you to work with Media ALREADY in the family tree.  You must define me-
dia using the Media Database Window.  Another important thing about media
records: you do not work with files from the system, rather logical names refer to
the media in your family tree.

    Since we don't have any media stored in our family tree, click the Media DB but-
ton (or press "M") so that we can add some.  See the figure below.  The Media DB win-
dow looks a lot like the Personal Media window.  From here, you
essentially make a catalog of all the files you want to use with
your family tree.  You can add new media records, edit text media
files, update entries in the database, search the database, and
bring up the editor.  Again, the Edit button and Editor button are
only available with note and source media.  There is no provision
for deleting entries.  You can effectively delete entries by using
Update.  Note that this is the Picture Media DB shown.  The Per-
sonal Media window always calls up the relevant Media DB win-
dow.

    Let's create some entries.  Select the New button (or press "N").  Immediately, a
requester will appear asking you to select a physical filename.  Select any file.  Don't
worry about whether it's an actual picture file; GenTree doesn't care until it actually has
to display the files.  (This feature allows you to add pictures in formats GenTree cannot
show and use your own picture viewer through the preferences).  Select the file and
press OK.  Now a logical name requester appears.  A logical name is a 255 character
string that refers to this file.  You will use this logical name throughout the program in-
stead of the physical filename.  It provides you with a level of data transparency.  If it's
easier, just think of it as a unique comment about the file.  Put anything you like in the
requester, say "Elizabeth M.  Grubb, Age 2, at Damascus House (12/92)" and click OK.
Select a few more pictures if you like.  Double-clicking on items in the list request will
display the picture (or play the sound, or view the note,...).  Double-clicking also works
in the Personal Media window.  When you are done, select OK to exit the window.  Se-
lecting Cancel will lose all your changes.

    Now we are back at the Personal Media window.  All the changes in the Media
DB window will not show up here.  Using the Add button (or "A" key), add a picture (or
two) for Elizabeth.  Click OK to save your changes.

    The procedures described above work the same for picture, sound, and note me-
dia.  However, the source media records are treated a little differently.  Let's return to
the Media Database Window for sources.  Select the Source icon (the footprint on a
page icon at the bottom of the Personal Info window, Family Info window, or Supple-
mental window).  This action brings up the Personal Media Window.  Select the Media
DB button to enter the Media Database Window.

    Media database records for sources are considerably more detailed.  This allows
you to enter exact information describing the sources of information you have rather
than a loose collection of text in some file.  Sources are one of the most important
pieces of genealogy.  Without adequate documentation of your sources, other genealo-
gists cannot trust your information.  GenTree allows you to enter many fields for
sources: classification, title, quality, fidelity, originator information to just name a few.
Also, like other media types, you can point to a physical media
file on disk.

    To illustrate the difference, select the New button (or
press the "n" key) in the Media Database window.  The Source
Data Entry Window will appear (see Figure).  It's a bewildering
number of fields at first.  Fortunately, GenTree helps you in this
window as well by providing lists.  Click to the left of many of
the fields and available options will appear.  Select Cancel and
navigate your way back to the Personal Information Window.

3.4    Saving Your Family Tree

    GenTree keeps all work within memory.  If you turned off your computer right
now (or quit), all of your changes would be lost.  Let's return to the main window.  Select
Return to Main from the Project Menu (if you are in the Personal Info Window, the close
gadget will also return you to the main window).

    Select Save from the Project Menu of the main window.  A file requester will ap-
pear asking you where you want to place your family tree (and media databases).  Enter
a path and filename and select OK.  After a few moments, your family tree will have
been saved.  GenTree saves your family tree and media databases in the directory you
specified.  Each member also has a file containing their unique information.  These files
are saved in the current Persons Directory (specified in preferences).  As disk space fill
up, you will want to change the Persons directory so that any new members will be
saved somewhere else (GenTree will prompt you for a new name if the disk fills up or
there is some other error saving a member file).  It is a good idea to have one directory
exclusively for the member files.  Note that you also free up memory by saving your
work to disk.

Warning: Do NOT delete, rename, or move member files.  GenTree stores their
physical location in the family tree DB.  If GenTree cannot find a file, it will display
a file requester asking you where it is.  However, this can get tedious if you have
moved many member files.  If you want to move your family tree, use Save As.
Use Delete from the Main window's project menu to delete family trees.

3.5    Displaying Pedigree Charts, Descendant Charts, And Family
Groups

    GenTree can create other documents to show relationships within your family.
There are pedigree charts (Alexandria was born of Samuel and Julie who were born
of...), descendant charts (Margery begat Tom and Sam who begat...), and family groups
(husband, wife, and all their children).

    You can create these charts from the main window or
the Info windows (Personal, Family, and Supplemental).
Let's create a descendant chart for Margery Ann Godsey.
From the main window, select Descendant Chart from the
Display menu.  The Descendant Chart requester will appear
(see figure).  The requester prompts you for the ID of the
member you want to display.  Enter "1" for the Member ID
and Chart number.  If you couldn't remember, you could
have pressed the Member ID button.  A list of the members
in the family tree would have appeared to choose from (like
with the father ID in the Family Info window).  Click Display.
After a few moments, Margery's descendant chart will ap-
pear (see figure).  The square box on the lower left allows
you to view charts which won't all fit on one screen.

    If you click your mouse pointer on one of the names
displayed on the chart, GenTree will create a new descen-
dant chart with that member as the head.  The left arrow
button in the lower left corner loads the previous generation as the chart head.  Gen-
Tree would first prompt you for whether to load the father or the mother as the head.

    Under the Display menu, there are four check mark items: Pedigree, Family
Group, Descendant, and Personal Information.  Please notice that the Descendant
menu item is currently checked.  These menu items control what type of operation Gen-
Tree performs when you click on a name.  Either a pedigree, descendant, or family
group chart would be displayed or the member's information would be loaded and you
would be taken to the Personal Information Window.  To change the chart, just select
one of the menu items, the next time you click on a name the new operation will be per-
formed.

    Finally, under the Display menu there is a menu item to print this chart to printer
or file.  After you are finished, click the Close window gadget or select Return from the
menu to return to the main window.


3.6    Printing Your Family Tree

    The final thing you need to learn is how to print your family tree.  In the previous
section you learned how to print the pedigree charts et al.  In this section, you will learn
how to print everything.  GenTree allows great control over which information you wish
to print.  You can just print member names (for a quick list of names and IDs in the data-
base), dates, family relationships, supplemental information, pedigree and/or descen-
dant charts, and media lists (and the notes or sources).  The print option creates an
ASCII stream of characters that may be sent to the printer or a file.

    GenTree cannot print pictures or sounds (printing a sound would be a trick).
However, lists of the pictures and sounds each member has can be printed.

    Select Print...  from the main window's project menu.
The Print Requester will appear (see figure).  From this re-
quester, you can pick and choose what family tree informa-
tion you wish to print.  In addition, you can print all the mem-
bers in your database, only updated member records, or
only a subset of members.  Clicking the Subset radio button
will bring up the Search requester you used in the Info win-
dows.  From the print requester, you also choose the order
of the members output.  GenTree allows you to sort by
name, id, birth date, birth country, death date, death country, or no sort at all.

    After you have configured everything to your liking, click OK.  GenTree will now
display a requester asking where you want the output to go.  The default is to the PRT:
device.  However, you may type in a different destination.  Clicking the Destination but-
ton will display a file requester.  When you have selected a destination, press return or
click the Print button to print.

Warning: Printing pedigree or descendant charts for an entire family tree can
take a LONG time.  Be sure this is really what you want to do before selecting
these options.  The options that require member records to be loaded (and slow
print processing thereby) are Family Members, Supplemental Info, Charts, and
Media.

    This concludes our tutorial.  Have Fun and Good Luck creating your family tree!


4    Reference

    This section provides a reference of the different windows and their functions.

4.1    Main Window

    GenTree's main window (figure at right) provides access
to the different windows used by GenTree to enter, print, and
display your family tree.  In addition, the main window is used to
read family trees from and write family trees to disk.

4.1.1        Menus

Project Menu - Create, open, join, save, delete, and print your
family trees.  Also,  modify GenTree preferences.
New        Create a new family tree.  Any old work will be lost so you will be
prompted to see if you are sure.
Open...    Open a previously saved family tree saved in GenTree's database
format.  Any old work will be lost so you will be prompted to see if
you are sure.
Join...        Navigates you to the Join Window to join the current database with
another GenTree database saved on disk.  This allows you to con-
catenate your family tree with another's.
WARNING: The Join operation, unlike all the edit operations, permanently
changes the database on disk! Be absolutely sure you want to perform a
join or work with a backup copy!
Save        Saves your updates to disk.  If your family tree has never  been cre-
ated before a file requester will prompt you for the database name.
Save As...    Saves your current database (and all support files)  to a new data-
base you specify with a file requester.
Delete...    Deletes a GenTree database (and all support files) from disk.  You
cannot delete the current database in memory.  You need to select
new first and then delete.
Print...        Navigates to the Print window to print information from the current
family tree.
About...    Displays the program version, contact information, free memory,
and the number of members, pictures, sounds, notes, and sources
defined in the current family tree.
Info...        Displays information about the current family tree: the  name of the
family tree, number of members, number of male and female mem-
bers (note that the sum of the male and female members may be
less than the number of members), number of pictures, number of
sounds, number of notes, number of sources, and the new/unsaved
members.
Preferences... Navigates to the Preferences window where you can set GenTree
preferences.
Quit        Exits the program.  If you have any unsaved data, you will be
prompted to see if you are sure.

Database Menu - Navigates you to the windows to create, edit, and delete members,
pictures, sounds, notes, and sources.
Update Person... Navigates to the member entry windows.  If your family tree is
not empty, it brings up a requester to query on records to edit or
you may select to create new records.
Update Picture... Navigates to the Media Database window where you may up-
date your picture media database.  If you want to edit personal me-
dia database entries, you must enter the member entry windows.
Update Sound... Navigates to the Media Database window where you may up-
date your sound media database.  If you want to edit personal me-
dia database entries, you must enter the member entry windows.
Update Note... Navigates to the Media Database window where you may update
your note media database.  If you want to edit personal media data-
base entries, you must enter the member entry windows.  Notes
are any text entries about a member or group of members.
Update Source... Navigates to the Media Database window where you may up-
date your source media database.  If you want to edit personal me-
dia database entries, you must enter the member entry windows.
Sources are the references from where you obtained your family
information.

Display Menu - Display pedigree charts, descendant charts, and/or Family Group forms
from this menu.
Pedigree...    Display the pedigree chart for a member of your family tree.  A
pedigree chart displays a member, his/her parents, grandparents,
great-grandparents, etc.  You are prompted for the member ID for
the member to display.  In addition, you may specify the chart ID.
By default, GenTree builds a pedigree chart with a generation
depth that will fit on the display window using the current display
font (specified in preferences).  You may override this default and
state an explicit number of generations.
Family Group... Display the Family Group for two member of your family tree.  A
family group is a male (usually the husband), a female (usually the
wife), and all their children (and their wives).  You are prompted for
the member ID for the member and their spouse to display.  In ad-
dition, you may specify the chart ID.
Descendant... Display the descendant chart for a member of your family tree.  A
descendant chart displays all the children of a member, the
children's children, etc.  You are prompted for the member ID for
the member to display.  In addition, you may specify the chart ID.
By default, GenTree builds a descendant chart with a generation
depth that will fit horizontally on the display window using the cur-
rent display font (specified in preferences).  You may override this
default and state an explicit number of generations.  The number of
descendants per generation is not limited in any way.  Use the pro-
portional gadget in the display window to see parts offscreen.

4.1.2        AppEvent

    The main window also supports the Workbench 2.0+ App event.  Drop a Gen-
Tree family tree icon on the main window and the family will automatically be loaded.
The old family tree is erased from memory.

4.2    Member Information And Data Entry Windows

    GenTree has three  data entry windows: personal information window, family in-
formation window, and supplemental information window.  These windows are the heart
of the GenTree program.  From them, you create, edit, and delete members in your
family tree.  Each window contains many fields to enter specific types of information
about that member.  In addition, you may connect the current member to
entries in your media databases.

    Each member has a unique ID associated with him/her.  Normally, you do not
need to enter values for the Personal ID.  The only time you need to know entries is for
entering family relationships.  Please see section 2.3 for more details.

    When you enter the member entry windows, you will always start at the personal
information window.  If you selected New for your query, you are presented with a blank
page.  If you queried the family tree for a subgroup, you will see the first record of the
sorted query.  The window title displays the member you are editing and the place
within the query list.

4.2.1        Buttons

    Next to many of the fields in the member entry win-
dows are invisible buttons (which ones may be discovered
through experimentation).  These buttons display a list re-
quester (see figure) from which you select the value you
want in the field.  These list requesters provide an easy way
to enter information.  You can use them to standardize your
entries as well.  The list requester displays text files
(contained in the GenTree/Lists directory) which you may edit with any word processor.
The list requester itself allows you to add, delete, and edit entries and search the list.
Double-click on a entry to exit the requester and have that value placed in the corre-
sponding field.

    The two buttons to the right of the member entry window navigate you to the
other member entry windows.  You cannot leave the personal information window until
an ID, and name have been entered.

    The four buttons to the lower left of the member en-
try windows (see figure) navigate you to the personal me-
dia DB windows.  From left to right, the buttons navigate
you to the picture, sound, note, and source personal media
databases.  From these windows, you attach entries in your media databases to the
current member.

    The three buttons on the lower right (see figure) dis-
play the previous member of a query list, the next member of
a query list, and search the database to create a query list
respectively.

4.2.2        Menus

    Each of the three member entry windows have the same general menus and
menu items.  The personal and supplemental information windows additionally contain
Copy and Paste menu items, and the personal information window has New, Duplicate,
and Delete as well.

Project Menu    - Save and configure your family tree.  Display database information, and
return to the main window.
Save        Saves your updates to disk.  If your family tree has never been cre-
ated before a file requester will prompt you for the database name.
Info...        Displays information about the current family tree: the name of the
family tree, number of members, number of male and female mem-
bers (note that the sum of the male and female members may be
less than the number of members), number of pictures, number of
sounds, number of notes, number of sources, and the new/unsaved
members.
Preferences... Navigates to the Preferences window where you can set GenTree
preferences.
Return to Main. Navigates you back to the main window.  The member record
you are working on is verified and saved to the database.

Record menu - Create and edit member records.  Go to records within the query.
Undo        Undoes any changes you have made since you entered this win-
dow.  Undo does not restore changes you have made from before
entering this window (say, if you had moved from the personal to
the family information window).
Revert        Restores the member record from disk.  All changes made to the
member are deleted.
Verify        Verify the information you have entered about this member.
New        Save the current member and create a new member record.
Copy        Copy the current member to RAM.  All of the member's  information
except for family links and personal media databases are copied.
Copy and Paste are intended for copying records between family
trees.
Duplicate    Duplicate the current member in the family tree.  All information is
copied.  Only the member's ID changes.
Paste        Paste a member you previously copied into this family tree.
Clear        Clear specific fields of the current member: the entire record, per-
sonal information, current spouse, current child, parents, residents,
occupations, or supplemental information.  What fields are available
to be cleared is dependent on the window you are in.
Delete        Delete the current member from the family tree (and delete all fam-
ily ties).  This function only deletes the member from member.  It is
not permanent until you save the family tree.
Parent
    Father        Go to the record for the current member's father.
    Mother    Go to the record for the current member's mother.
Spouse...    Go to the record for the spouse of the current member.  If there is
more than one spouse, you may choose the specific spouse from a
list requester.
Child...    Go to the record for the child of the current member.  If there is
more than one child, you may choose the specific child from a list
requester.
Search For...    Go to the search requester to perform a subquery on the family
tree.
First        Display the first record in the query list.
Previous    Display the previous record in the query list.
Next        Display the next record in the query list.
Last        Display the last record in the query list.

Display Menu - Display pedigree charts, descendant charts, and/or Family Group forms
from this menu.  By default, GenTree selects the current member ID.
Pedigree...    Display the pedigree chart for a member of your family tree.
Family Group... Display the Family Group for two member of your family tree.
Descendant... Display the descendant chart for a member of your family tree.

4.2.3        Windows

    From these windows you enter a member's information.  The three data entry
windows are the Personal Information window, the Family Information window, and the
Supplemental Information window.  Use the RETURN key or TAB key to jump from one
field to the next.  The SHIFT-TAB key jumps you to the previous field.  Any information
you need to add for which there is not a field, you should use the notes media database.

4.2.3.1    Personal Information Window

    The personal information window allows you to create, edit, and delete member
records.  You may enter the member's ID, name, gender, birth date and place, and
death date and place.  List requesters exists for the gender, and birth/death location,
city, county, state, country, and cause of death.

4.2.3.2    Family Information Window

    The family information window is where you tie your family tree together.  From
here, you select (or create) your member's spouses, children, and parents.  List re-
questers exists for the spouse ID, child ID, father ID, and mother ID.

    The two radio buttons, Spouses and Children, cycle through the member's
spouses and children respectively.  To enter a new spouse or child, press the radio but-
ton until the fields clear.  Do NOT use the clear button; you will delete the family tie be-
tween that member and that relation.

4.2.3.3    Supplemental Information Window

    The supplemental information window allows to add supplemental information
about your member.  You may enter the member's different jobs, residences, military
service, religion, immigration information, baptismal and confirmation dates.  List re-
questers exist for the occupation type; residence city, state, and country; immigration
location, and religion.

    The two radio buttons, Occupations and Residences, cycle through the
member's jobs and homes respectively.  To enter a new job or residence, press the ra-
dio button until the fields clear.  Do NOT use the clear button; you will delete the
member's job or residence.

4.3    Media Databases

    GenTree allows you to link media (pictures, sounds, notes, and sources) to the
members of your family tree.  There are four global media databases (one for each me-
dia type) that hold all media files you have defined in your family tree.  Each member
may also have four personal media databases which point to specific entries of the glo-
bal media databases.  Multiple members may use the same entries from the global
media databases.  Note that this makes it easy to make global changes.

4.3.1        Global Media Databases

    The media databases store picture, sound, note, and source references inside
your family tree for coupling with your family members.  Members may have their own
unique references within the media databases, or several members may refer to the
same picture (, sound, note, etc.).  The media databases only store references, not the
actual media.  If you delete or move a media file from AmigaDOS, GenTree will not be
able to find it.

    All media types work generally the same except for the source references.
Sources store much more specific information than just the logical name and a file-
name.  When you create or update a source, the Source Data Entry window appears.
See section 4.3.3 for more information on the Source Data Entry window and how to
work with sources.

    The sizes of the media databases are limited only by memory.  The more
memory you have, the more references you may have.  However, since GenTree only
stores the physical filename, even in a small memory system you can store hundreds of
references.

    You enter references into the media databases using the
same media database window (see figure).  From this window, you
may add new entries, update current entries, edit note and source
files using your default editor, and search the media database for a
specific reference.  In addition, double-clicking on an entry will have
that file loaded and displayed (or played if you are using the sound
media database window).

To add picture, sound, or note entries to a media database:
·    Click on the New button.  A file requester will appear.  The default directory for
the file requester is the default directories you specified for the media in prefer-
ences.
·    Select a file using the file requester and click OK.  You may select any type of
file.  GenTree doesn't restrict the type to allow for new file types GenTree may
not understand, but which your default player or viewer may.
·    Enter a unique logical name for this file and press return.  The logical name is
what you will use to refer to this media file throughout the rest of the program.
The logical name may be any characters you wish and has a maximum length of
255 characters.

Note: The logical name must only be unique for the specific media database; dif-
ferent media databases may have the same logical name.  Also, the same physi-
cal filename may be referenced multiple times within the same (or even different)
database.  (This is a waste of space, but you may find it necessary if you want
tailored logical names for different members).

To add source entries to the source media database:
·    Click on the New button.  The Source Data Entry window will appear.
·    Enter information into the fields.  You must enter a title (this is the same thing as
the logical name for the other media types).
·    Select OK to exit the window.

To update picture, sound, or note entries in a media database:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.  Highlight your selection.
·    Click on the update button.  A file requester will appear already pointing to the
file tracked by this reference.
·    If this is the correct file, just click OK.  Otherwise, use the file requester to find
the correct file and then click OK.  The logical name will then be shown.
·    Again, you may edit the logical name or leave it as is.  Click OK.

To update source entries in the source media database:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.  Highlight your selection.
·    Click on the update button.  The Source Data Entry window will appear with all
the information you have previously filled in.
·    If this is the correct file, just click OK.  Otherwise, change the fields to what you
desire.
·    Click OK to save your changes.

To delete entries in a media database:
·    You cannot directly delete entries in a media database.  Instead, use the  update
procedure to overwrite the entry with a new entry.

To view/play entries in a media database:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.
·    Double-click on the entry.  If you are in the picture media database window,
GenTree will try to display the picture/brush/brushanim/...  If you are in the sound
media database, the program will try to play the sound.  If you are in the note or
source media database, it will try to display the ASCII text.  GenTree uses the
default viewers/players you define in preferences.  If no viewer/player is defined,
GenTree will use its internal routines.  Please refer to Appendix C to see what file
formats are supported.

To edit text files (notes or sources):
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.  Highlight the entry.
·    Click the Edit button.  GenTree uses the default editor you define in preferences.
If no editor is defined, GenTree will use MomentED, its internal ASCII editor.
Please refer to the MomentED section for more details on this editor.  The file-
name for the note or source is automatically loaded into the editor.  Sometimes
nothing seems to happen.  Usually, this means that the editor is not properly de-
fined in preferences.  Editors known to work are ED and Final Copy II.
·    Make your changes, save them and quit.  To use the editor without loading  any
file (you might want to do this if there are no text files on disk to add), select the
Editor button.

To make a text file (for notes or source information not in the Source Data Entry win-
dow):
·    Click the Editor button to load your editor.
·    Type in your note and save it.
·    Quit the editor.
·    Follow the procedures for adding an entry outlined earlier.

4.3.2        Personal Media Databases

    Your members' personal media databases point to specific media tracked within
the media databases.  Each member may have unlimited media connected to him/her.
Again, you are only limited by memory or disk space.  The personal media databases
are stored in the member file.  If you lose this file, you lose the links (the entries still ex-
ist in the media databases though).

    You enter references into a member's record by using the per-
sonal media window (see figure).  This window is only reachable
through the member entry windows.  The member you are currently
displaying on the member entry window is the personal media data-
base that you are modifying.  From the personal media window, you
may add entries to your member record, delete entries from the mem-
ber (but not the media database itself), edit notes and sources using
your default editor, and search the personal media database for a spe-
cific reference.  In addition, double-clicking on an entry will display (or play) the entry.
You may also go to the media database window in order to edit the media database.

To add entries to a member's personal media database:
·    Click on the Add button.  A list requester will appear containing all of the  entries
in the relevant media database.  You cannot add entries until entries exist in the
media database.  If you need to add entries to the global media database, select
the Media DB button.
·    Double-click on the entry you want.

To remove entries from a member's personal database:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.  Highlight the entry.
·    Click the Remove button.

To view/play entries:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.
·    Double-click on the entry.

To edit notes or sources:
·    Find the entry you want to view/play using the scroll bar or searching for the  logi-
cal name.  Highlight the entry.
·    Click the Edit button.  GenTree uses the default editor you define in preferences.
·    Make your changes, save them and quit.  To use the editor without loading  any
file (you might want to do this if there are no text files on disk to add), select the
Editor button.  Any changes you make to the file will be reflected for all member
personal databases that reference that file.

4.3.3        Source Data Entry Window

    This window (See figure) provides you with fields for
completely entering source information.  Sources represent
the submitter's justification for the opinions asseted in the
family tree.  It provides the evidence obtained for the infor-
mation and gives an idea of how much confidence other ge-
nealogists can have in the data.  The Title field is the same
as the logical name for the other media types.  It is the only
required field.  Other fields are optional and depend on the classification of the source.

4.3.3.1    Buttons

    Next to many of the fields are buttons which will display a list of choices for that
field.  Click the button and select the choice (by double-clicking on the choice or high-
lighting the choice and selecting OK).  The following fields have lists: classification,
quality, fidelity, originator type, and publication type.

4.3.3.2    Fields

    The following fields enable you to meet the minimum standards for defining
source references for a family tree.

Classification.  A code which classifies the source which contained the evidence
data.  For example, an official census or a church record.
Title        A descriptive string for the source.  For example, 1890 Census
Records.
Quality    The submitter's assessment of he reliability of the source.  Please
use the list requester for this field.
Fidelity    A code which provides an assessment of the exactness of the
source material.  For example, an original record being cited, a
photocopy of the original, a transcription of the original, or an
abridgement of the original.
Page Description.  A description which identifies the page within the source.  It
may be a page number, range, or anything other description of hor
to find the referenced information within the source.  For example,
Page 212 - middle paragraph.
Originator Name.  The name of the person or organization that created the
source.  For example, the US Government.
Originator Type.  The type of organization or person that created the source.  For
example, author, organization, or interviewer
Publication Title.  The name of the publication such as a book name, periodical
name, or newspaper.  For example, The Washington Star.
Publication Type.  The type of publication that is the source.  For example, a
book, periodical, newspaper, etc.
Publication Publisher.  The name of the publisher that created the source.  For
example, Simon & Schuster.
Publisher Address.  The address of the publisher that created the source.
Publication Date.  The date the source was published.  For example,
12-May-1800.
Publication Edition.  A description of the specific version of the publication being
referenced.  For example, 2nd Printing.
Physical Filename.  An optional file that may be attached to the source.  It may
be any type of file: a picture of the evidence, a descriptive voice an-
notation, etc.

4.4    Genealogical Charts

    GenTree provides genealogical charts for outputting your family tree.  You can
display pedigree charts, descendant charts, and family groups.  You can create these
charts from the main window or the member entry windows.

4.4.1        Pedigree Charts

    Pedigree charts lists a member's pedigree (i.e.  par-
ents, grandparents, great grandparents, etc.) To display a
pedigree chart, select the pedigree menu item from the dis-
play menu.  A requester (see figure) will appear prompting
you for whom you want to display.  You must enter a mem-
ber ID.  There is a list requester available by pressing the
Member ID button.  In addition, you may enter the chart ID
and the number of generations to display.  By default, GenTree displays as many gen-
erations as will fit on the display screen using the display font (set in preferences).  For
each member displayed in the pedigree chart (except the last generation), GenTree dis-
plays the ID, name, birth/death date and place, and, under the male, the marriage date
if any.  Finally, you may turn off the display of birth/death place by deselecting the
check-marked button.

    After clicking the Display button (or hitting carriage return), the pedigree informa-
tion will be compiled and displayed.  Click the close button to exit back to your window.

4.4.2        Descendant Charts

    Descendant charts show the descendants of one
member (his/her children, their children, etc.) To display a
descendant chart, select the descendant menu item from
the display menu.  A requester (see figure at left) will ap-
pear prompting you for whom you want to display their de-
scendants.  You must enter a member ID.  There is a list
requester available by pressing the Member ID button.  In
addition, you may enter the chart ID and the number of generations to display.  By de-
fault, GenTree displays as many generations as will fit on the display screen horizon-
tally using the display font (set in preferences).  For each member displayed in the de-
scendant chart, GenTree displays the ID, name, and the birth/death dates and places.
You may turn off the display of birth/death places by deselecting the check-marked but-
ton.

    After clicking the Display button (or hitting carriage return), the descendant infor-
mation will be compiled and displayed.  Click the close button to exit back to your win-
dow.

4.4.3        Family Groups

    A family group shows one family i.e.  a father, a
mother, and any children.  To display a family group, select
the family group menu item from the display menu.  A re-
quester (see figure at left) will appear prompting you for a
member and their spouse to display.  You must enter the
member's ID.  There is a list requester if you forget available by pressing the Member ID
button.  There also exists a spouse ID requester which will list all of the spouses of the
member in the member ID field.  Members without a spouse may leave the spouse ID
field blank.  If the member has a spouse, you must enter the ID.  Finally, you may enter
the chart ID for recordkeeping purposes.

    After clicking the Display button (or hitting carriage return), the family group infor-
mation will be compiled and displayed.  Click the close button to exit back to your win-
dow.

4.4.4        Printing Charts

    You may also print your charts and family groups.  The charts may be output to
file or to the printer.  If you want to output to the printer, GenTree uses the application
specified in the GFXPrint field for preferences.  The default printing application is
GenTree's internal application.  For other printer application, GenTree will grab the
screens for the charts, save them to RAM, and create a script file containing the filena-
mes and paths.  The script filename is inserted into the GFXPrint screen at the asterisk.
For example, "SYS:Utilities/Display from * opt bp t=1" becomes "SYS:Utilities/Display
from Ram:T/GT/scriptlist opt bp t=1".  This string is fed as a CLI
command to AmigaDOS.

To print a chart or family group:
·    Display a chart/group using the  procedure outlined in the
previous sections.
·    From the Display screen, select  Print from the menu.  A print
requester will appear (see figure previous page).
·    Click the print button to send the output to the printer.  If you want the display  to
go to file, click the Destination button and fill in a path and filename first.

4.5    MomentED

    The Moment Editor (MomentED) is a full-featured ASCII editor integrated into the
GenTree program.  It is called the Moment Editor because it took me only a "moment"
to create.  MomentED provides a superb example of CanDo; it took me approximately 3
days to complete.  MomentED provides the following features:

·    Document sizes are limited only by memory
·    Unlimited number of documents open at once (again limited by RAM)
·    Undo feature
·    Block and line copy and paste in same document or between documents
·    Sort Document or block in ascending order ignoring case
·    Find and Replace utilities

    If you have used a word processor or text editor before, you will be entirely com-
fortable with MomentED.  You access the editor by selecting the Edit or Editor button
from the Media windows (Personal or Global).  The current document's name is dis-
played in the window title bar.

    Here is a list of MomentED's menus and their functions:

Project Menu - Create, open, and save documents.
New        Create a new, blank document.  The new document will become
the current document.  Other documents in memory are not lost.
Open...    Open a previously saved document.  The opened  document will
become the current document.  Other documents in memory are
not lost.
Close        Close the current document.  If there are other documents avail-
able, MomentED will swap to one of those.  Otherwise, a new,
blank document will appear.
Save        Save the current document using the current name.  Only the cur-
rent document is saved.
Save As...    Save the current document using a new name.  A file requester ap-
pears from which you select the path and filename.  Only the cur-
rent document is saved.
Print...        Print the current document.  A requester appears from which you
may specify the destination of the document.  The default destina-
tion is the printer.  Only the current document is printed.
About...    Displays the version of  MomentED.  In addition, memory usage,
the number of documents loaded, and the size of the current docu-
ment (in characters and lines) are displayed.
Quit...        Exits the program.  If any of  the documents currently loaded have
been changed, you are requested to see if you are sure.

Edit Menu - Edit the document.
Undo        Undo your last change.  Beware, switching between documents
means you cannot undo your change.
Cut        Cut the currently selected block from the document.  You must first
select a block using the mark begin and end keys (detailed below).
Copy        Copy the currently selected block from the document.  You must
first select a block using the mark begin and end keys (detailed be-
low).
Paste        Paste the block you cut, copied, or sorted at the current cursor po-
sition.
Sort block    Sort the currently selected block.  The block is sorted on the first
character of each line of the block in
ascending order.  The case of words is
ignored.
Clear        Clear the current document.

Utilities - Modify text for the document.
Find...        Displays the Find Requester (see fig-
ure).  You can search for characters by
word or string, case-sensitive or not.
Change...    Displays the Change requester (see
figure).  From this requester, you can
search for an occurrence of a certain
string and replace it with another
string.  You have the option of search-
ing by word or string and with-
case-sensitivity or not.  After the string
is found, you have the option to make
the change, skip this occurrence, or
replace all occurrences.
Margins...    Displays the Margin requester (see figure next page).  From this
requester, you can change the margins
for the entire document.  You specify
the left margin and the right margin.
Any left margin greater than one will
cause all lines to have spaces inserted
on the left to "left justify" the lines.
Sort        Sort the entire current document.  The
document is sorted on the first charac-
ter of each line in ascending order.  The case of words is ignored.

Window Menu - Display help screen or switch the current document.
Help        Displays the help screen listing all hot keys for the editor.
Select...    Displays a list requester allowing you to select the current docu-
ment.
First        Swaps the current document with the first document in memory.
Next        Swaps the current document with the next document in memory.
Previous    Swaps the current document with the previous document in
memory.
Last        Swaps the current document with the last document in memory.

Here is a list of MomentED's hot keys and their functions:
Ctrl-[        Select the start point of a block.  This key is used with the Ctrl-] key
to delimit a block.  After you have delimited a block, you can cut,
copy, or sort the block.
Ctrl-]        Select the end point of a block.  This key is used with the Ctrl-[ key
to delimit a block.  After you have delimited a block, you can cut,
copy, or sort the block.
Ctrl-Y        Delete the current line.
Alt-Y        Paste the line last deleted at the current cursor position.
LeftAmiga-Y    Delete from the current cursor position to the beginning of  the line.
RightAmiga-Y. Delete from the current cursor position to the end of the line.
Ctrl-X        Clear the current line.  A blank line is left where the line used to be.
Ctrl-Up    Move the cursor to the top of the document.
Ctrl-Down    Move the cursor to the bottom of the document.
Ctrl-Left    Move the cursor to the beginning of the current line.
Ctrl-UP    Move the cursor to the end of the current line.
Shift-Up    Move the cursor up one page of the document.
Shift-Down    Move the cursor down one page of the document.
Shift-Left    Move the cursor to the beginning of the previous word.
Shift-UP    Move the cursor to the beginning of the next word.
Help        Display help screen.

4.6    Preferences

    GenTree allows extensive control over the appearance and behaviour of the pro-
gram.  From a preferences screen, you can change fonts, fontsizes, default directories,
and other parameters.

4.6.1        Defaults

    On start-up, GenTree uses the preferences specified in the GenTree.Def file
(contained in the same directory) or, if it cannot find this file, internal default prefer-
ences.  This way, by using the GenTree.Def file, you can set up default preferences for
the start of each session.  In addition, every family tree you
create contains the preferences used at the time you saved
it.

    The preferences window (see figure) allows you to
change any of GenTree's preferences.  Listed below are the
preferences, their definitions, and their defaults as specified
internally:
Font        This parameter specifies the font used
in all GenTree execution windows ex-
cept the Chart Display window.  Any font in your FONT: directory
may be used (even outline fonts).  The Default font is "Times".
Font Size    This parameter specifies the size of the default font.  The default
font size is 11 points.
Display Font    This parameter specifies the font used in displaying family groups
and charts.  Any font in your FONT: directory may be used (even
outline fonts).  The Default font is "Times".
Display Font Size. This parameter specifies the size of the display font.  The de-
fault display font size is 11 points.
Year Range    This parameter is used with the search requester.  When you
specify About in the birth or death date, GenTree will search for
members that satisfy that date plus or minus Year Range years.
This number must be an integer.  The default value is plus or minus
5 years.
Report Labels Justification.  This parameter controls how the labels in a printed
report appear: either left-justified, right-justified, or centered.  The
default value is left-justified.
Put Page Breaks in report?  This parameter controls whether a line feed or a
page break is placed between every member output in a report.
The default value is false.
SEENOTES is TRUE for sorts?  This parameter controls how GenTree interprets
the date format: SEENOTES.  When sorting, if this option is true,
the SEENOTES dates will always be less than, greater than, or
whatever the sort is.  The default value is true.
Create Icons? This parameter controls whether or not GenTree creates an icon
for your family tree when it is saved or when something is "printed"
to a file.  A check means that icons will be created.  The default is
on.  This parameter is closely related to the All Products parameter.
All Products? This parameter controls whether or not GenTree creates icons for
all files it produces.  Since GenTree makes a file for every member
in your family tree, this option should be left off.  However, for those
who just need to waste disk space this option exists.  A check
means that icons will be created.  The default is off.
Convert Dates? This parameter controls when GenTree converts dates whether
or not it will display the GenTree default date format.  By leaving
this option off, GenTree will still validate dates.  However, the text
string you input will remain.  This allows you to use display date for-
mats you are more comfortable with (for example, spelling out the
entire month).  The default is on.
Compare Full Dates?  This parameter controls how GenTree compares dates.
When this option is true, GenTree uses the date modifiers (After,
Before, Between, and About) and tries to figure out which date is
less than (or greater than) another.  This can get tricky if GenTree
is comparing dates like After 1990 and Before 1991.  This options
make sorts take longer since the logic is harder.  The default value
is true.
Display Birth/Death Locations? This parameter is used when GenTree generates
charts or family groups.  You can save space on the display by not
showing the birth and death locations in your charts.  The default is
on.
Default Directories (pictures, sounds, notes, sources, and persons). These fields
specify the default directories for where GenTree first looks for that
type of file.  Do not fill in the filename! In the case of the persons
directory, the parameter controls where any new members will be
saved when you next save the family tree.  This allows you to save
new members on different disks (or directories) as available space
is used up.  The defaults for these directories are the directories
located in the GenTree default directory.
Notes & Sources -- Editor -- This parameter specifies the default editor to use
whenever you want to edit a note or source.  Leaving this field
blank uses the internal GenTree editor, MomentED.  Note that you
must give the full path and editor name AND, if any spaces exist,
you must surround the path and file with quotes.  When you select
a file to edit, GenTree appends the filename to this field and tries to
run it.  The default is to use MomentED.
Note: I have successfully tested Final Copy II and Ed.
Notes & Sources -- Viewer -- This parameter specifies the default text viewer to
use whenever you want to view a note or source.  Leaving this field
blank uses the internal GenTree text viewer.  Note that you must
give the full path and viewer name AND, if any spaces exist, you
must surround the path and file with quotes.  When you select a
text file to view, GenTree appends the filename to this field and
tries to run it.  The default is to use the internal text viewer.
Note: I have successfully tested More and MuchMore.
Pictures & Sounds -- Viewer -- This parameter allows you to extend the function-
ality of GenTree by using a third party picture viewer, to display for-
mats not supported, GIF, JPEG, IFF24, etc.  Leaving this field blank
uses the internal GenTree picture viewer.  Note that you must give
the full path and viewer name AND, if any spaces exist, you must
surround the path and file with quotes.  When you select a picture
to view, GenTree appends the filename to this field and tries to run
it.  The default is to use the internal viewer.
Note: I have successfully tested and use ViewTek (VT).  I heartily recommend
using this excellent viewer.  With it, you can display JPEG, IFF24, and full screen
animations.
        You may also place the filename of an AREXX script in this field.
Pictures & Sounds -- Player -- This parameter allows you to extend the function-
ality of GenTree by using a third party picture sound player, to play
formats not supported.  Currently, GenTree will only play IFF 8SVX.
Note that you must give the full path and player name AND, if any
spaces exist, you must surround the path and file with quotes.
When you select a sound to play, GenTree appends the filename to
this field and tries to run it.  The default is to use the internal player.
Note: You may also place the filename of an AREXX script in this field.
Pictures & Sounds -- GFXPrint -- This parameter controls the printing of your
charts and family groups from the charts window.  GenTree uses
the value in this field to print the IFF of the screen.  GenTree saves
the screens to RAM and creates a file called ScriptList.  This file
lists all files to print.  When you select print, GenTree inserts the
path and name into the GFXPrint string.  The name is inserted at
the asterisk.  The current default is GenTree's internal code.  An-
other default might look like "SYS:Utilities/Display from * opt bp
t=1." This assumes that Display is in your utilities drawer.

4.6.2        Changing The Defaults

    You may change any preferences using GenTree's preferences window.  Some
parameters you modify by checking on/off the button.  Others require text input.  But-
tons next to parameter fields display requesters to aid you in filling in proper text.  The
Font and Display Font buttons will display the fonts contained in your FONT: directory.
Double-click on the font you wish to use.  The Font Size and Display Font Size buttons
display the sizes available for that font.  For outline fonts, a standard list of sizes is dis-
played.  Under WB 2.0, you may use font sizes not specifically available for that font.
The directories and media buttons display a file requester for you to find the relevant
file/directory.

4.7    Joining GenTree Databases

    GenTree provides the ability to join family trees to make one colossal family tree.
In fact, if you wish to enter a GEDCOM tree into your database, joining is the only way
to do so.  After GenTree converts the GEDCOM file to GenTree format, you combine
the new tree to your own family tree.  You don't have to join your family tree with the en-
tire other family tree, GenTree allows you to perform sub-
queries on the joining family tree before adding it to yours.

    To join family trees, you must have a family tree al-
ready loaded.  After loading your family tree, select Join...
from the project menu of the main window.  The Join win-
dow will appear (see figure) which is where you control how
the two family trees are joined.  The very first thing you
must do is find the GenTree database you want to add.
The field at the top of the window informs you what family
tree you are adding.  You can change this database if you
want.

    By default, GenTree wants to join every member from the entire newdatabase
with your current GenTree database.  However, you can select only a subset of those
members by pressing the Subset of members radio button.  GenTree will bring up the
Search requester where you may limit the members to join.  Also by default, GenTree
only imports members, not any of the media databases.  If you want to combine the me-
dia databases as well, check the appropriates boxes.

    When everything is to your satisfaction, click the OK button and GenTree will join
the two databases.  You will then need to go into the Personal information windows to
update the links between the families or to delete any unnecessary members.

Warning! The join operation is irrevocable.  GenTree creates new member
records on disk (or whereever the Persons Dir is set in the preferences window)
and saves the database.  If you are not sure of what you are doing, use a work-
ing copy of the your family tree instead.

4.8    Printing GenTree Databases

    Genealogical information would not be as useful if you couldn't print it out.  So, of
course, GenTree provides a printing capability.  Using the print option, you can dump all
or portions of your family tree to the printer or to a file.  This print file is an ASCII file
which you may later edit.  If you want to print the graphic pedigree charts or other charts
you made, use the print option from the display window.

    To print your family tree, select Print...  from the
project menu of the main window.  The Print requester will
appear (see figure).  From this requester, you decide ex-
actly what portions of your family tree to print.

    Select the All Members (default), Subset of Members
radio button or Only Updated Members radio button to
choose what members to print.  If you select the Subset of
Members button, GenTree will provide the Search Re-
quester for you to choose the criteria by which members are selected.  This is the stan-
dard search requester used throughout GenTree allowing you to query by ID, name,
gender, and birth/death dates and countries.  If the Only Updated Members button is
selected, only members changed since the last save will be printed.  You can get a list
of changed member records by choosing the Info... menuitem from the main window.

    The two buttons on the right control in what order the members are printed.  By
cycling through the options, you can print the members unsorted or sorted in ascend-
ing/descending order by ID, name, gender, birth date, birth country, death date, or death
country.

    Finally, all the check boxes at the bottom control what parts of a member's infor-
mation is printed.  A check in the box means that option will be printed.  The options are
explained below:
Members    Checking this box displays the members' names and IDs.  If this
box is unchecked you cannot select the Dates, Places, Family
Members, Supplemental or Charts boxes.
Birth & Death Dates. Checking this box displays each members' birth date and
death date.
Birth & Death Places. This box controls the display of each members' birth place
and death place.
Family Members. Checking this box displays for each member their spouses,
children, father, and mother.  These members may be displayed
later, but this shows the relationship, the family ties.
Supplemental. Checking this box displays all the information you entered in the
supplemental information window for each member printed.
Pedigree Charts. Checking this box directs GenTree to build a Pedigree chart for
each member displayed.  The pedigree chart is not graphical,
rather it shows the relationships through text placement.  This op-
tion increases the time to print dramatically since GenTree must get
multiple records for each member it prints.
Descendant Charts. Checking this box directs GenTree to build a Descendant
chart for each member displayed.  The descendant chart is not
graphical, rather it shows the relationships through text placement.
This option increases the time to print dramatically since GenTree
must get multiple records for each member it prints.
List Pictures    Checking this box will display the logical names of all the pictures
associated with each member printed.
List Sounds    Checking this box will display the logical names of all the sounds
associated with each member printed.
List Notes/Full Notes/No Notes. This button cycles through 3 options for display-
ing notes.  List Notes displays the logical names of the notes asso-
ciated with the member.  Full notes displays the entire note of all
the notes in the member's personal note media database after the
member.  No Notes displays nothing from the members' note data-
base.
List Sources/Full Sources/Refer Srcs to EndNotes/No Sources. This button
cycles through 4 options for displaying sources (references).  List
Sources displays the logical names of the sources associated with
the member.  Full Sources displays the entire source text of all the
references in the member's personal note media database after the
member.  Refer Srcs to EndNotes displays, for each printed mem-
ber, the logical names of the sources referenced in their personal
media database and prints the entire source text at the end after all
members have been printed.  No Sources displays nothing from the
members' source database.